home *** CD-ROM | disk | FTP | other *** search
/ AOL File Library: 4,401 to 4,500 / aol-file-protocol-4400-4401-to-4500.zip / AOLDLs / PDA-Newton Development / ND Newt Development Environm / newt-devenv-31.sit / packages.txt < prev    next >
Text File  |  1995-08-11  |  7KB  |  158 lines
  1. packages.txt
  2. 8/11/95
  3. Newt 3.1
  4. (c) 1995, S. Weyer, All Rights Reserved Worldwide.
  5. weyer@netaxs.com
  6.  
  7.  
  8. With Newt 3.1, it is possible to save packages directly on the Newton. For
  9. this you need the NewtPack plug-in which is provided with the standard
  10. release.
  11.  
  12.  
  13. Configuration?
  14.  
  15. The NewtPack included with Newt 3.1 should work on ALL Newtons. For
  16. older/original, pre-1.3 ROMs, non-upgraded OMP (Original MessagePads),
  17. NewtPack must use a "small saving method" which limits the size of final
  18. packages.  You should still be able to create modest-sized (~30-40K)
  19. packages. When NewtPack begins to save, the version/configuration appears
  20. -- NewtPack appends "+S" to the version number if it is using this "small"
  21. method.
  22.  
  23. NewtPack is relatively slow.  However, since you can build and test your
  24. applications in Newt, you do not need to create a package until toward the
  25. end of your development process. There is a version of NewtPack available
  26. to registered users that contains various amount of native (RISC) code. It
  27. is currently ~20% faster than the regular version, and somewhat larger -- I
  28. will continue to profile and improve performance.
  29.  
  30. If you used the older RUNewt mechanism, see "RUNewt" at end.
  31.  
  32.  
  33. Use
  34.  
  35. When you install NewtPack, it does not appear in Extras since it is an
  36. "autopart".  When Newt starts up, it finds the NewtPack plug-in, and
  37. automatically uses it to save your application, either via the Save button
  38. or :saveApp.  As your package saves, NewtPack displays the most recent slot
  39. at bottom left, and current package size at bottom right.
  40.  
  41. The status bar shows progress (in bytes) toward a possible package size. Since
  42. NewtPack can't compute an accurate size in advance, it defaults to 40K,
  43. though you can give NewtPack a better hint -- so, don't worry if NewtPack
  44. appears to terminate half-way through or keeps on going for awhile
  45. (especially if you're copying platform functions or other large "constants").
  46.  You will hear a "funbeep" if it's successful and the progress box will
  47. automatically disappear; or, you will hear an error beep, see a message, and
  48. a close box should appear on the progress box.
  49.  
  50. If there is an existing package with the same "appSymbol", e.g., myApp:Newt,
  51. NewtPack asks you to confirm removing the old package before proceeding. If an
  52. error occurs during saving, you might try again after a fresh restart, in
  53. case a heap problem was reported; otherwise, if you're creating an autopart
  54. or using an installScript, look at the examples & docs again...
  55.  
  56.  
  57. Manipulating Packages
  58.  
  59. If the package successfully saved and installed, it should be
  60. indistinguishable from an NTK-created package, and you should be able to
  61. use utilities that archive packages and manipulate Extras, e.g., NewtCase,
  62. ScrollEx, etc.  You may wish to obtain one of these, or at least a utility
  63. that will allow you to scroll the "Remove Software" list -- newer system
  64. updates from Apple have a utility called "Package Mover" that allows the
  65. "Prefs:Memory:Remove Software" list to scroll. Let me know which work best
  66. for you (or don't work) so that I can pass along this info.
  67.  
  68. In addition to beaming any NTK or Newt package to another Newton via a utility
  69. like BeamPkg or ScrollEx, you can backup the package to your Mac or PC with
  70. Newton Connection Kit. Once there, you can extract the package from the NCK
  71. backup file with an Extract Package utility (and then copy to floppy, upload
  72. somewhere or attach to email).
  73.  
  74. ExtractPackages 1.1 (for the Mac)
  75. author: markus_fritze@hh2.maus.de; CIS: 100074,3560
  76.   ftp://ftp.amug.org/pub/newton/mac-only/extract-packages_1.1.sit.hqx
  77.   AOL: pack.sit (1.0?)
  78.   CIS:NEWTON: EXTRAC.SIT
  79.   eWorld:Newton:Utilities: ExtractPackage 1.1
  80.  
  81. ExtractPackage 1.1 (or 2.0?) (for Windows)
  82. author: raf@rough.demon.co.uk
  83.   ftp://ftp.amug.org/pub/newton/dos-only/extrap2l.zip.hqx
  84.   AOL: extrap21.zip
  85.   CIS: EXTRAP.SIT
  86.  
  87. Some Windows users have experienced problems with Extract Package. One thing
  88. to check is that you have msafinx.dll installed; this may be avail with
  89. Visual Basic 3.0.
  90.  
  91. Please support authors of other utilities by sending words of
  92. encouragement or money as appropriate.
  93.  
  94.  
  95.  
  96. Distribution
  97.  
  98. Of course, what you do with these packages is your own decision. If you plan
  99. to distribute to others, I'd be glad to review designs and source and
  100. beta-test, as time permits. Please include the following acknowledgment in
  101. your "readme" (text file or online help):
  102.   This application created with the Newt Development Environment (Newt 3.1).
  103.   For further information, browse: http://www.netaxs.com/~weyer
  104.   or contact: weyer@netaxs.com.
  105.  
  106. Also, if you let me know the package location/URL, I can add your Newt-generated
  107. package to the list on my web page:  www.netaxs.com/~weyer/newton/releases.html
  108. and tell others about it.
  109.  
  110. If you plan to sell your packages, I do not charge royalties -- it would be
  111. appreciated if you registered Newt. Although I assume that Apple does not
  112. have legal rights to information that your applications create, anything is
  113. possible, so this situation could change; all disclaimers and caveats apply.
  114. My view is that Apple will be well-rewarded by having additional development
  115. tools available:
  116. - many more software packages to make the platform attractive to users
  117. - many more developers, many of whom upgrade to NTK tools and support
  118. - wider choices of development features & platforms
  119. - and, if enough of you register for Newt, I will be forced over a revenue
  120.   threshhold and have to start paying 1% royalties to Apple
  121.  
  122.  
  123.  
  124. Future
  125.  
  126. Performance.  Now that NTK 1.5 is available, I will profile and compile
  127. selected methods as native (RISC) code. There is a version available to
  128. registered users that is ~20% faster, and I expect this to improve somewhat
  129. (though not dramatically) over time.
  130.  
  131. Stability. NewtPack's package model is based on some earlier public info
  132. (thanks to Dave Fedor, Matthew Faupel), plus some ViewFrame archaelogy and
  133. a lot of trial-and-error and educated guesses. Although I think NewtPack is
  134. robust and relatively complete, based on the several dozen examples that
  135. I've tested, and packages that users have created (no bugs have been
  136. reported), I will be more confident after further testing and/or if real
  137. package info becomes available from Apple (I have been requesting & waiting
  138. for ~2 years).
  139.  
  140. Completeness. NewtPack currently handles regular apps ("forms"), autoparts
  141. and books; a future version will likely handle fonts, stores and other
  142. objects/attributes.
  143.  
  144.  
  145.  
  146. RUNewt
  147.  
  148. I have removed the older, separate "RUNewt" mechanism & info.
  149. (RUNewt was used before packages (pre- Newt 3.0) to save and run applications).
  150.  
  151. You can remove the "RUNewt:TKnollSys" package. If you are careful, you can
  152. remove the "RUNewt:Apps:TKnollSys" soup, and the "RunNewtRun:TKnollSys"
  153. System preference with a soup utility like StewPot.
  154.  
  155.  
  156.  
  157.  
  158.